home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / sblaster / musics.zip / MUSICSHO.DOC next >
Text File  |  1991-03-19  |  8KB  |  145 lines
  1.                                      MUSIC SHOW
  2.                                       by Jerbs
  3.  
  4. Music Show (MUSICSHO.EXE) is a utility for the playing of CMF song files and the 
  5. showing of either PCX graphic files or Kaleidoscopic patterns.  Music Show 
  6. requires a SoundBlaster music adapter from Creative Labs, Inc. to play the CMF 
  7. files.  The SBFMDRV.COM driver for this board must be loaded prior to running 
  8. Music Show.  Music Show also requires at least an EGA to show the Kaleidoscopic 
  9. patterns and a graphics adapter that matches the resolution requirements of the 
  10. particular PCX files.  Music Show should support video modes through "SuperVGA" 
  11. on such adapters as Tseng, Paradise and Video Seven, but I have only tested it 
  12. on standard VGA adapters.  Music Show should have no harmful effects of any kind 
  13. on your equipment if the above conditions aren't met (or even if they are), but 
  14. I accept no responsibility whatsoever for any damage of any kind including 
  15. sterility, hostility, loss of bladder control or those embarrassing dandruff 
  16. flakes.  Hey, this is ShareWare stuff here!  You are free to give it to anybody 
  17. who might enjoy it, but I'd rather you kept these files (MUSICSHO.EXE, 
  18. MUSICSHO.DOC, and SBFMDRV.COM) together.
  19.  
  20. To run Music Show, use the following command line and optional parameters:
  21.  
  22. MUSICSHO [file.cmf|/Ccmflist.asc] [file.pcx|/Ppcxlist.asc] [/Nn] [/F] [/K]
  23. or
  24. MUSICSHO /?
  25.  
  26. Use /? parameter to show a help screen.
  27.  
  28. Use FILE.CMF to listen to a particular CMF file
  29. Use CMFLIST.ASC to listen a list of CMF files
  30.  
  31. Use FILE.PCX to show a particular PCX file
  32. Use PCXLIST.ASC to show a list of PCX files
  33.  
  34. CMFLIST.ASC and PCXLIST.ASC are ASCII lists of file names.  Such lists would 
  35. include the file names desired, including their full paths if different than the 
  36. current directory and/or drive.  If no lists or filenames are given, an 
  37. interactive selection is used.
  38.  
  39. Use /K to force viewing of Kaleidoscope pattern during music.
  40.  
  41. Use /F to show CMF and PCX file names during music show.  The default is to NOT 
  42. show the file names.
  43.  
  44. Use /Nn to play the songs and show the files n number of times.  The default is 
  45. to loop indefinitely until the Esc key is pressed.
  46.  
  47. During music play, press Esc to quit program, Enter to advance to next song.
  48.  
  49. During kaleidoscope, use V to toggle Vertical symmetry in graphic display, H to 
  50. toggle Horizontal symmetry and B to cycle Background color.
  51.  
  52. THE HISTORY OF MUSIC SHOW
  53.  
  54. Several years ago, somebody gave me a little public domain program for the 
  55. Commodore C64 that showed basic kaleidoscopic patterns on the screen (in 
  56. wonderful 320 x 200 x 4 color resolution) while playing some surprisingly 
  57. pleasant tunes on the SID chips in the C64.  Years went by and I left the C64 
  58. behind for a "serious" computer (read: IBM).  My PC included marvelous video 
  59. capabilities (VGA) and excellent audio capabilities (SoundBlaster).  I had video 
  60. games galore that took advantage of both.  I had a growing collection of PCX 
  61. files (PCX files can be created by many PC bitmap packages, my personal favorite 
  62. being Electronic Arts Deluxe Paint II Enhanced) and GIF files (a file format 
  63. distributed on Compuserve and used by many BBSs) and utilities to show both (an 
  64. especially good one is Bob Montgomery's excellent shareware VPIC, which handles 
  65. AND TRANSLATES many file formats on a huge variety of PC graphic adapters).  I 
  66. even had some very good kaleidoscope programs (the very best of which is J. R. 
  67. Shiflett's mind-blowing DAZZLE, a must-have!).  I was also collecting a lot of 
  68. music files (there are many ROL files out there but I chose to used Creative 
  69. Labs' ROL2CMF converter to convert them to the far superior CMF format) and had 
  70. a few simple utilities to play one CMF song at a time.  But nowhere did I find a 
  71. song player that also did graphics!  And it wasn't just me!  A friend of mine 
  72. runs his own computer store and runs separate programs first to show graphic 
  73. files and then to play music after the graphics are all gone.  All this power 
  74. and nothing to compare to that little Commodore 64 program!
  75.  
  76. So I got disgusted and wrote one.  Now, I am a very lazy programmer with a short 
  77. attention span, so I wanted to knock out something as quick and as dirty as I 
  78. could.  I allotted myself one lazy Sunday afternoon for this project.  Luckily, 
  79. I program in Microsoft QuickBASIC, so I can program very quickly (you just can't 
  80. beat QuickBASIC for fast development!).  I also have available a lot of language 
  81. extension libraries that allowed me to do some pretty slick routines with an 
  82. absolute minimum of work on my part (like Crescent Software's Quick Pac 
  83. Professional for file manipulation and the menu selection stuff, Genus 
  84. Microprogramming's PCX Toolkit for bringing in PCX files and Creative Labs, 
  85. Inc.'s Sound Blaster Developer Kit).  Now, I'll be the first to admit that 
  86. QuickBASIC suffers a bit from bloated EXE sizes, so I ran my resulting program 
  87. through a friend's copy of PKWARE's PKLITE (which I can see I'm definitely going 
  88. to have to buy for myself!).  By the way, have pity on my Kaleidoscopic pattern 
  89. algorithm.  I know it's no prize winner, but at least you can diddle with it 
  90. while it works and I did spend only about 20 minutes coming up with it.  I was 
  91. going to spend a serious amount of time on it and be really dazzling, but after 
  92. I saw Shiflett's DAZZLE, I decided anything I could do in my allotted afternoon 
  93. would be so lame in comparison that I might as well just roll over and play 
  94. dead.  Arf.
  95.  
  96. Now some of you may be asking why I didn't use GIF and ROL files instead of PCX 
  97. and CMF files.  Well, I preferred the somewhat larger PCX files over GIF files 
  98. because I have several paint packages I can create and edit PCX files in and, 
  99. truthfully, it was a heckuva lot easier to view PCX files with my trust GENUS 
  100. toolkit.  Also, since we're being honest here, I used CMF files over ROL files 
  101. partially because I had the Sound Blaster Developer Kit and could play a CMF 
  102. file with just a dozen or so lines of code.  The other reason is that ROL files 
  103. store their instruments in a separate "bank" file and, if you have a large bank 
  104. file (like BANK835.BNK that I've seen on Compuserve with 835 instruments in it), 
  105. it can take a long time for your ROL player to search the BNK file to find the 
  106. needed instruments.  CMF files store the instruments right in them and BANG! 
  107. play the music right now.  Also, CMF files can even store the song composer, 
  108. title and 30 or so characters of other comments right in the file.  Very nice.  
  109. One disadvantage is that the Sound Blaster Developer Kit does not play version 
  110. 1.0 CMF files, only version 1.1 or higher.  Also, I've noticed that the rare 1.1 
  111. CMF file will produce no volume at all with the toolkit.  Oh well, it was still 
  112. easy to write.
  113.  
  114. I've mentioned several products here and I should probably give them credit.  If 
  115. the following information is incorrect, it is my fault and not the vendors or 
  116. authors of these fine products.
  117.  
  118. Microsoft QuickBASIC
  119. Crescent Software QuickPac Professional
  120. GENUS Microprogramming PCX Toolkit
  121. Creative Labs, Inc. SoundBlaster, SoundBlaster Developer Kit, SBFMDRV and 
  122. ROL2CMF
  123. PKWARE PKLITE
  124. Electronic Arts Deluxe Paint II Enhanced
  125. J. R. Shiflett's Dazzle
  126. Bob Montgomery's VPIC
  127.  
  128. I have seen DAZZLE.EXE, VPIC.EXE, ROL2CMF.EXE, SBFMDRV.COM, BANK835.BNK (and 
  129. other BNK files) and many GIF, PCX, ROL and CMF files on Compuserve and many 
  130. other private BBSs.  VPIC is an excellent tool for converting many slide formats 
  131. to PCX.  ROL2CMF, along with appropriate BNK files, is an excellent tool for 
  132. converting ROL files to CMF files.  Vernors makes the only REAL ginger ale in 
  133. the world, a true programmers drink with real bite and snap.  If you enjoy this 
  134. silly application, drop me a line.  If you REALLY want to thank me (though why I 
  135. don't know, because this isn't exactly the kind of program that will make you 
  136. rich or cure male pattern baldness), plant a tree somewhere.  If such a gesture 
  137. just absolutely won't satisfy you, send me a copy of your favorite CMF, PCX, ROL
  138. or GIF file for me to play on my copy of Music Show.
  139.  
  140. Jerbs
  141. 137 Dogwood Dr.
  142. Oakland, MI  48363
  143. Compuserve ID: 75140,514
  144.  
  145.